home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_200 / 256_02 / read.me < prev    next >
Encoding:
Text File  |  1988-01-06  |  4.8 KB  |  133 lines
  1.  
  2.     CARRY FLAG FILES
  3.     ----------------
  4.  
  5.     The files on this disk are practically all of the kind where
  6.     the Carry Flag is set to indicate an error.   They have been
  7.     written in Assembly Language to suit the De Smet Compiler and
  8.     to take advantage of the De Smet flag "_carryf".   They have
  9.     all been written to use INT 21H other than the direct disk
  10.     read/write functions (INT's 25H and 26H) which will be found
  11.     in the DOS1 subdirectory.
  12.  
  13.     For convenience I have grouped the routines into the following
  14.     categories -
  15.  
  16.               DOS1          Routines which first were used in MS-DOS
  17.                             Version 1.x but which might have been
  18.                             superceeded by later MS-DOS 2.x routines.
  19.               ERRORS        All of the present MS-DOS error codes and
  20.                             a routine ("printerr") to print the error
  21.                             message when a routine returns an error
  22.                             code.
  23.               FUN4BH        The "EXE" and "OVERLAY" functions which
  24.                             are available under Function 4BH of INT
  25.                             21H.
  26.               FILES         Functions relating to specific files such
  27.                             as opening a file, closing a file and so
  28.                             on.   They are for use with MS-DOS 2.x and
  29.                             later versions.
  30.               MEMORY        Functions which relate to the use of free
  31.                             memory under MS-DOS 2.x and later.
  32.               DIRECTRY      Directory functions under MS-DOS 2.x and
  33.                             later.
  34.               FUN44H        Most, although not all, of the Microsoft
  35.                             networking functions which all use INT
  36.                             21H Function 44H under MS-DOS 2.x and
  37.                             later.
  38.  
  39.     In addition there are several files which occur in the main
  40.     directory.   These are -
  41.  
  42.               FUN38H        Get the Country data of the system
  43.               SETCTRY       Set the Country data
  44.               NETNAME       Obtain the Computer Name using Function
  45.                             5EH Code 0.
  46.               GETPSP        Get the Programme Segment Prefix segment
  47.                             address of the running programme.
  48.               ENDPROC       Terminate a procedure
  49.               GETRET        Get Return Code of a child process
  50.               GETSTATE      Get Verify State of the system (i.e.
  51.                             whether write operations to disk files
  52.                             are being verified)
  53.  
  54.     For a description of the way each file has been written please
  55.     refer to the file -
  56.  
  57.               CARRYF.TXT
  58.  
  59.     which occurs in the main directory of this disk.
  60.  
  61.     A complete list of the ("_carryf") files in the sub-directories is 
  62.     as given below.   In each case both the source code and the 'bind'
  63.     code (xxxx.O) is given.
  64.  
  65.     ----------------------------------------------------------------------
  66.     DOS1
  67.     ----
  68.     FUN6H          FUN12H          FUN23H
  69.     FUN0FH         FUN13H          ABSREAD
  70.     FUN10H         FUN17H          ABSWRITE
  71.     FUN11H         FUN1CH
  72.  
  73.     ERRORS
  74.     ------
  75.     ERRLIST.C      PRINTERR
  76.  
  77.     FUN4BH
  78.     ------
  79.     LEXE           LOVLAY
  80.  
  81.     FILES
  82.     -----
  83.     FNDFIRST       FUN3DH          SETATTR         UNLOCK
  84.     FNDNEXT        FUN3EH          FUN45H
  85.     FUN56H         FUN3FH          FUN46H
  86.     GDATIME        FUN40H          FUN5AH
  87.     SDATIME        FUN42H          FUN5BH
  88.     FUN3CH         GETATTR         LOCKFIL
  89.  
  90.     MEMORY
  91.     ------
  92.     FUN4BH         FUN4AH          SETSTRAT
  93.     FUN49H         GETSTRAT
  94.  
  95.     DIRECTRY
  96.     --------
  97.     FUN39H         FUN3AH          FUN3BH          FUN41H
  98.     FUN47H
  99.  
  100.     FUN44H
  101.     ------
  102.     GETDEV         BLKSEND         MEDTYPE
  103.     SETDEV         BLKGET          CHKREM
  104.     SENDDATA       INSTAT          CHKHNDL
  105.     GETDATA        OUTSTAT         RETRY
  106.  
  107.     ----------------------------------------------------------------------
  108.  
  109.     Lastly, I have also provided two system utilities namely -
  110.  
  111.               LISTFILE.EXE
  112.               LABEL.EXE
  113.  
  114.     The first allows you to print out any of the listings given on the
  115.     disk.   It has been set for a standard (US) paper size of 66 lines
  116.     per page.   If the alterable settings don't suit your type of
  117.     printer just ignore these and press 'p' (when you come to the menu)
  118.     to print the file.
  119.  
  120.     The LABEL programme allows you to enter a Volume (disk) Name at any
  121.     time you wish.   It can also be used to change the existing name of
  122.     a disk.   I believe this function is included in DOS 3.x but I don't
  123.     have DOS 3.x so I wrote my own utility.   It is a good example of
  124.     the type of programme which can be written using De Smet C and the
  125.     routines on this disk.
  126.  
  127.     Phil E. Cogar,
  128.     P.O. Box 364,  Narrabeen,
  129.     N.S.W.   AUSTRALIA  2101
  130.     ------------------------
  131.  
  132.     1st November, 1987
  133.     ------------------